home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / SgColorChooser.z / SgColorChooser
Text File  |  1998-10-30  |  37KB  |  595 lines

  1.  
  2.  
  3.  
  4.      SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr - The ColorChooser widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<SSSSggggmmmm////CCCCoooolllloooorrrrCCCC....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents the version of Sgm that accompanies
  17.           Motif 2.1.
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.           ColorChooser is a dialog widget that provides a friendly and
  21.           powerful user interface for selecting colors. The
  22.           ColorChooser provides a color hexagon and color sliders that
  23.           presents the color range in Hue, Saturation, Value, (HSV)
  24.           and Red, Green, Blue, (RGB) color spaces.  Because of
  25.           drawing speed considiration, the color hexagon and color
  26.           sliders are available only if running under GL. For X only
  27.           configuration there are Scale widget to replace the color
  28.           sliders and there is no color hexagon.  The ColorChooser
  29.           includes the following:
  30.  
  31.  
  32.             +o  A menu for setting options for the color chooser.
  33.  
  34.             +o  A color hexagon that provides visual selection of the
  35.                Hue and Saturation components of a color in an Hue,
  36.                Saturation, Value, (HSV) color space.
  37.  
  38.             +o  Color slider for each of Hue, Saturation, Value, Red,
  39.                Green, Blue color components. The color sliders are
  40.                visible depening on the user color chooser menu
  41.                selection.  Each of the color sliders and the color
  42.                hexagon is accompanied with a text edit widget to view
  43.                the exact value of the current color component and to
  44.                set it's numerical value.
  45.  
  46.             +o  Two color swatches: one for showing the current
  47.                selected color and one for enabling the user to atore a
  48.                second color for reference.
  49.  
  50.             +o  Three or four buttons
  51.  
  52.  
  53.           The default button labels are OOOOKKKK, CCCCaaaannnncccceeeellll, and HHHHeeeellllpppp.  By
  54.           default an AAAAppppppppllllyyyy button is also created; if the parent of
  55.           the ColorChooser is a DialogShell it is managed, and
  56.           otherwise it is unmanaged.  Additional children may be added
  57.           to the ColorChooser after creation.  The first child is used
  58.           as a work area. The work area is placed just below the menu
  59.           bar.  Additional children are laid out in the following
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           manner:
  75.  
  76.  
  77.             +o  Buttons-All XXXXmmmmPPPPuuuusssshhhhBBBBuuuuttttttttoooonnnn widgets or gadgets, and their
  78.                subclasses are placed after the OOOOKKKK button in the order
  79.                of their creation.
  80.  
  81.             +o  The layout of additional children that are not in the
  82.                above categories is undefined.
  83.  
  84.  
  85.           The user can select a color by manipulating the color
  86.           hexagon and any of the six sliders or changing the value of
  87.           a color components text widgets.
  88.  
  89.           The default configuration provides control for an HSV color
  90.           space. The Hue and Saturation are controlled by the color
  91.           hexagon and the Value is controlled by the value slider.
  92.  
  93.           Selecting to view the RGB sliders provides controls over RGB
  94.           color space.  Selecting both RGB and HSV slider provide Hue
  95.           and Saturation slider to manipulate the Hue and Saturation
  96.           in addition the the color hexagon.
  97.  
  98.           The default value for the XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd resource
  99.           XXXXmmmmNNNNccccaaaannnncccceeeellllBBBBuuuuttttttttoooonnnn is the Cancel button.  The default value for
  100.           the XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd resource XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn is the OK
  101.           button unless.
  102.  
  103.           For ColorChooser and its subclasses, the default value for
  104.           XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss is the Hue text edit area.
  105.  
  106.         CCCCllllaaaasssssssseeeessss
  107.           ColorChooser inherits behavior and resources from CCCCoooorrrreeee,
  108.           CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, and XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd
  109.           Classes.
  110.  
  111.           The class pointer is ssssggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  112.  
  113.           The class name is SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr.
  114.  
  115.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  116.           The following table defines a set of widget resources used
  117.           by the programmer to specify data.  The programmer can also
  118.           set the resource values for the inherited classes to set
  119.           attributes for this widget.  To reference a resource by name
  120.           or by class in a .Xdefaults file, remove the SSSSggggNNNN or SSSSggggCCCC
  121.           prefix and use the remaining letters.  To specify one of the
  122.           defined values for a resource in a .Xdefaults file, remove
  123.           the SSSSgggg prefix and use the remaining letters (in either
  124.           lowercase or uppercase, but include any underscores between
  125.           words).  The codes in the access column indicate if the
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))
  137.  
  138.  
  139.  
  140.           given resource can be set at creation time (C), set by using
  141.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  142.           not applicable (N/A).
  143.  
  144.                                       SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  145.      NNNNaaaammmmeeee                         CCCCllllaaaassssssss                  TTTTyyyyppppeeee              DDDDeeeeffffaaaauuuulllltttt           AAAAcccccccceeeessssssss
  146.      ______________________________________________________________________________________________
  147.      XmNapplyCallback             XmCCallback            XtCallbackList    NULL              C
  148.      XmNapplyLabelString          XmCApplyLabelString    XmString          dynamic           CSG
  149.      XmNcancelCallback            XmCCallback            XtCallbackList    NULL              C
  150.      XmNcancelLabelString         XmCCancelLabelString   XmString          dynamic C
  151.      XmNokCallback                XmCCallback            XtCallbackList    NULL              C
  152.      XmNokLabelString             XmCOkLabelString       XmString          dynamic           CSG
  153.      XmNvalueChangedCallback      XmCCallback            XtCallbackList    NULL              C
  154.      XmNdragCallback              XmCCallback            XtCallbackList    NULL              C
  155.      SgNshowSliders               SgCShowSliders         SgRShowSliders    SgRGB_and_HSV     CSG
  156.      SgNwysiwyg                   SgCWysiwyg              XmRBoolean       True              CSG
  157.      SgNuseGl                     SgCUseGl                XmRBoolean       True              CSG
  158.      SgNstoredColorLabelString    XmCXmString            XmString          "Stored Color"    CSG
  159.      SgNcurrentColorLabelString   XmCXmString            XmString          "Current Color"   CSG
  160.      SgNhueLabelString            XmCXmString            XmString          "Hue"             CSG
  161.      SgNsaturationLabelString     XmCXmString            XmString          "Saturation"      CSG
  162.      SgNvalueLabelString          XmCXmString            XmString          "Value"           CSG
  163.      SgNredLabelString            XmCXmString            XmString          "Red"             CSG
  164.      SgNgreenLabelString          XmCXmString            XmString          "Green"           CSG
  165.      SgNblueLabelString           XmCXmString            XmString          "Blue"            CSG
  166.  
  167.  
  168.  
  169.           SSSSggggNNNNaaaappppppppllllyyyyCCCCaaaallllllllbbbbaaaacccckkkk
  170.                     Specifies the list of callbacks called when the
  171.                     user activates the AAAAppppppppllllyyyy button.  The callback
  172.                     reason is SSSSggggCCCCRRRR____AAAAPPPPPPPPLLLLYYYY.
  173.  
  174.           SSSSggggNNNNaaaappppppppllllyyyyLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  175.                     Specifies the string label for the AAAAppppppppllllyyyy button.
  176.                     The default for this resource depends on the
  177.                     locale.  In the C locale the default is "Apply".
  178.  
  179.           SSSSggggNNNNccccaaaannnncccceeeellllCCCCaaaallllllllbbbbaaaacccckkkk
  180.                     Specifies the list of callbacks called when the
  181.                     user activates the CCCCaaaannnncccceeeellll button.  The callback
  182.                     reason is SSSSggggCCCCRRRR____CCCCAAAANNNNCCCCEEEELLLL.
  183.  
  184.           SSSSggggNNNNccccaaaannnncccceeeellllLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  185.                     Specifies the string label for the CCCCaaaannnncccceeeellll button.
  186.                     The default for this resource depends on the
  187.                     locale.  In the C locale the default is "Cancel".
  188.  
  189.           SSSSggggNNNNhhhheeeellllppppLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  190.                     Specifies the string label for the HHHHeeeellllpppp button.
  191.                     The default for this resource depends on the
  192.  
  193.  
  194.  
  195.      Page 3                                         (printed 10/24/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                     locale.  In the C locale the default is "Help".
  207.  
  208.           SSSSggggNNNNooookkkkCCCCaaaallllllllbbbbaaaacccckkkk
  209.                     Specifies the list of callbacks called when the
  210.                     user activates the OOOOKKKK button.  The callback reason
  211.                     is SSSSggggCCCCRRRR____OOOOKKKK.  If the selection text does not match
  212.                     a list item, and SSSSggggNNNNmmmmuuuussssttttMMMMaaaattttcccchhhh is True, the
  213.                     SSSSggggNNNNnnnnooooMMMMaaaattttcccchhhhCCCCaaaallllllllbbbbaaaacccckkkk callbacks are called instead.
  214.  
  215.           SSSSggggNNNNooookkkkLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  216.                     Specifies the string label for the OOOOKKKK button.  The
  217.                     default for this resource depends on the locale.
  218.                     In the C locale the default is "OK".
  219.  
  220.           SSSSggggNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  221.                     Specifies the list of callbacks called when the
  222.                     user selects a color.  The callback reason is
  223.                     XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.  A color is selected when the
  224.                     user changes the value of a color component via
  225.                     the color hexagon, one of the color sliders, or
  226.                     one of the color components text widgets.
  227.  
  228.           SSSSggggNNNNddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk
  229.                     Specifies the list of callbacks called when the
  230.                     user drags the mouse over the color hexagon or one
  231.                     of the color sliders to select a color.  The
  232.                     callback reason is XXXXmmmmCCCCRRRR____DDDDRRRRAAAAGGGG.
  233.  
  234.           SSSSggggNNNNsssshhhhoooowwwwSSSSlllliiiiddddeeeerrrrssss
  235.                     Specifies which color slider is visible. If the
  236.                     useGl resource is False, then SgNshowSliders
  237.                     specifies which color scales are visible.
  238.                     Possible values are:
  239.  
  240.           SSSSggggNNNNssssttttoooorrrreeeeddddCCCCoooolllloooorrrrLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  241.                     Specifies the string label for the SSSSttttoooorrrreeeedddd CCCCoooolllloooorrrr
  242.                     button.
  243.  
  244.           SSSSggggNNNNccccuuuurrrrrrrreeeennnnttttCCCCoooolllloooorrrrLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  245.                     Specifies the string label for the CCCCuuuurrrrrrrreeeennnntttt CCCCoooolllloooorrrr
  246.                     button.
  247.  
  248.           SSSSggggNNNNhhhhuuuueeeeLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  249.                     Specifies the string label for the HHHHuuuueeee button.
  250.  
  251.           SSSSggggNNNNssssaaaattttuuuurrrraaaattttiiiioooonnnnLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  252.                     Specifies the string label for the SSSSaaaattttuuuurrrraaaattttiiiioooonnnn
  253.                     button.
  254.  
  255.           SSSSggggNNNNvvvvaaaalllluuuueeeeLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  256.                     Specifies the string label for the VVVVaaaalllluuuueeee button.
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                         (printed 10/24/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))
  269.  
  270.  
  271.  
  272.           SSSSggggNNNNrrrreeeeddddLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  273.                     Specifies the string label for the RRRReeeedddd button.
  274.  
  275.           SSSSggggNNNNggggrrrreeeeeeeennnnLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  276.                     Specifies the string label for the GGGGrrrreeeeeeeennnn button.
  277.  
  278.           SSSSggggNNNNbbbblllluuuueeeeLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  279.                     Specifies the string label for the BBBBlllluuuueeee button.
  280.  
  281.  
  282.                       +o  SSSSggggVVVVaaaalllluuuueeee Show only the slider for the color
  283.                          Value
  284.  
  285.                       +o  SSSSggggRRRRGGGGBBBB____aaaannnndddd____VVVVaaaalllluuuueeee Show the Value and RGB
  286.                          sliders
  287.  
  288.                       +o  SSSSggggRRRRGGGGBBBB____aaaannnndddd____HHHHSSSSVVVV Show all six sliders, the HSV
  289.                          and RGB sliders
  290.  
  291.  
  292.           SSSSggggNNNNwwwwyyyyssssiiiiwwwwyyyygggg
  293.                     Specifies whether the wysiwyg mode is True or
  294.                     False. If the wysiwyg mode is True, then the
  295.                     sliders and hexagon change color to show the color
  296.                     that will be selected in each point of the hexagon
  297.                     or slider.  If the wysiwyg mode is False, then the
  298.                     hexagon color always shows with Value (intensity)
  299.                     equals 1 (maximum intensity) and the RGB sliders
  300.                     shows color range of black to max RGB color
  301.                     component value.  For example, if the current
  302.                     selected color RGB value is (100, 200, 50), then
  303.                     with wysiwyg mode True the Red color slider will
  304.                     have the colors (0, 200, 50)-(255, 200, 50), and
  305.                     with wysiwyg mode False the range
  306.                      (0, 0, 0) - (233, 0, 0).  Note that this mode is
  307.                     meaninful only if useGl resource is True.
  308.  
  309.           SSSSggggNNNNuuuusssseeeeGGGGllll  Specifies whether to set the useGl mode to True or
  310.                     False. If the useGl mode is True then the color
  311.                     hexagon and color sliders are visble.  The color
  312.                     hexagon and color sliders use GL's Gouraud shading
  313.                     to display the colors in the hexagon and sliders.
  314.                     If useGl mode is False then the widget uses only X
  315.                     calls. In this case there will be no color
  316.                     hexagon, and the color sliders are replaced with
  317.                     XmScale widgets.
  318.  
  319.  
  320.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  321.           ColorChooser inherits behavior and resources from the
  322.           following superclasses.  For a complete description of each
  323.           resource, refer to the man page for that superclass.
  324.  
  325.  
  326.  
  327.      Page 5                                         (printed 10/24/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))
  335.  
  336.  
  337.  
  338.                                SSSSggggBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  339.      NNNNaaaammmmeeee                  CCCCllllaaaassssssss                TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt        AAAAcccccccceeeessssssss
  340.      _________________________________________________________________________________
  341.      XmNallowOverlap       XmCAllowOverlap      Boolean          True           CSG
  342.      XmNautoUnmanage       XmCAutoUnmanage      Boolean          True           CG
  343.      XmNbuttonFontList     XmCButtonFontList    XmFontList       dynamic        CSG
  344.      XmNcancelButton       XmCWidget            Widget           dynamic        SG
  345.      XmNdefaultButton      XmCWidget            Widget           dynamic        SG
  346.      XmNdefaultPosition    XmCDefaultPosition   Boolean          True           CSG
  347.      XmNdialogStyle        XmCDialogStyle       unsigned char    dynamic        CSG
  348.      XmNdialogTitle        XmCDialogTitle       XmString         NULL           CSG
  349.      XmNfocusCallback      XmCCallback          XtCallbackList   NULL           C
  350.      XmNlabelFontList      XmCLabelFontList     XmFontList       dynamic        CSG
  351.      XmNmapCallback        XmCCallback          XtCallbackList   NULL           C
  352.      XmNmarginHeight       XmCMarginHeight      Dimension        10             CSG
  353.      XmNmarginWidth        XmCMarginWidth       Dimension        10             CSG
  354.      XmNnoResize           XmCNoResize          Boolean          False          CSG
  355.      XmNresizePolicy       XmCResizePolicy      unsigned char    XmRESIZE_ANY   CSG
  356.      XmNshadowType         XmCShadowType        unsigned char    XmSHADOW_OUT   CSG
  357.      XmNtextFontList       XmCTextFontList      XmFontList       dynamic        CSG
  358.      XmNtextTranslations   XmCTranslations      XtTranslations   NULL           C
  359.      XmNunmapCallback      XmCCallback          XtCallbackList   NULL           C
  360.  
  361.                                           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  362.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  363.      _________________________________________________________________________________________________
  364.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
  365.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  366.      XmNforeground           XmCForeground           Pixel               dynamic                CSG
  367.      XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
  368.      XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
  369.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
  370.      XmNinitialFocus         XmCInitialFocus         Widget              dynamic                CSG
  371.      XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  372.      XmNshadowThickness      XmCShadowThickness      Dimension           dynamic                CSG
  373.      XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
  374.      XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
  375.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
  376.      XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
  377.      XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
  378.      XmNuserData             XmCUserData             XtPointer           NULL                   CSG
  379.  
  380.                              CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  381.      NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  382.      ______________________________________________________________________
  383.      XmNchildren         XmCReadOnly         WidgetList    NULL      G
  384.      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  385.      XmNnumChildren      XmCReadOnly         Cardinal      0         G
  386.  
  387.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                         (printed 10/24/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))
  401.  
  402.  
  403.  
  404.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  405.      ______________________________________________________________________________________________________________
  406.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                N/A
  407.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  408.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  409.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  410.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  411.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  412.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  413.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  414.      XmNdepth                        XmCDepth                        int              dynamic                CG
  415.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  416.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  417.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  418.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  419.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  420.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  421.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  422.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  423.      XmNx                            XmCPosition                     Position         0                      CSG
  424.      XmNy                            XmCPosition                     Position         0                      CSG
  425.  
  426.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  427.           A pointer to the following structure is passed to each
  428.           callback:
  429.  
  430.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  431.           {{{{
  432.             iiiinnnntttt          _r_e_a_s_o_n;;;;
  433.             XXXXEEEEvvvveeeennnntttt       * _e_v_e_n_t;;;;
  434.             sssshhhhoooorrrrtttt        _r, _g, _b;;;;
  435.           }}}} XXXXmmmmCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;;
  436.  
  437.  
  438.           _r_e_a_s_o_n Indicates why the callback was invoked.
  439.  
  440.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback.
  441.  
  442.           _r      Indicates the red color component of the currently
  443.                  selected color.
  444.  
  445.           _g      Indicates the green color component of the currently
  446.                  selected color.
  447.  
  448.           _b      Indicates the blue color component of the currently
  449.                  selected color.
  450.  
  451.  
  452.           The color components range from 0 (no intensity) to 255
  453.           (maximum intensity).  This is the same range used by Iris GL
  454.           (RRRRGGGGBBBBCCCCoooolllloooorrrr((((3333GGGG))))).
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                                         (printed 10/24/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))
  467.  
  468.  
  469.  
  470.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  471.           XmColorChooser inherits translations from XmBulletinBoard.
  472.  
  473.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  474.           The ColorChooser widget has the additional behavior
  475.           described below:
  476.  
  477.  
  478.           MMMMAAAAnnnnyyyy KKKKCCCCaaaannnncccceeeellll:
  479.                     Calls the activate callbacks for the cancel button
  480.                     if it is sensitive.  If no cancel button exists
  481.                     and the parent of the ColorChooser is a manager,
  482.                     passes the event to the parent.
  483.  
  484.           KKKKAAAAccccttttiiiivvvvaaaatttteeee:
  485.                     Calls the activate callbacks for the button with
  486.                     the keyboard focus.  If no button has the keyboard
  487.                     focus, calls the activate callbacks for the
  488.                     default button if it is sensitive.
  489.  
  490.           <<<<OOOOKKKK BBBBuuuuttttttttoooonnnn AAAAccccttttiiiivvvvaaaatttteeeedddd>>>>:
  491.                     Calls the XXXXmmmmNNNNooookkkkCCCCaaaallllllllbbbbaaaacccckkkk callbacks with reason
  492.                     XXXXmmmmCCCCRRRR____OOOOKKKK.
  493.  
  494.           <<<<AAAAppppppppllllyyyy BBBBuuuuttttttttoooonnnn AAAAccccttttiiiivvvvaaaatttteeeedddd>>>>:
  495.                     Calls the XXXXmmmmNNNNaaaappppppppllllyyyyCCCCaaaallllllllbbbbaaaacccckkkk callbacks with reason
  496.                     XXXXmmmmCCCCRRRR____AAAAPPPPPPPPLLLLYYYY.
  497.  
  498.           <<<<CCCCaaaannnncccceeeellll BBBBuuuuttttttttoooonnnn AAAAccccttttiiiivvvvaaaatttteeeedddd>>>>:
  499.                     Calls the XXXXmmmmNNNNccccaaaannnncccceeeellllCCCCaaaallllllllbbbbaaaacccckkkk callbacks with reason
  500.                     XXXXmmmmCCCCRRRR____CCCCAAAANNNNCCCCEEEELLLL.
  501.  
  502.           <<<<HHHHeeeellllpppp BBBBuuuuttttttttoooonnnn AAAAccccttttiiiivvvvaaaatttteeeedddd>>>>:
  503.                     Calls the XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk callbacks with reason
  504.                     XXXXmmmmCCCCRRRR____HHHHEEEELLLLPPPP.
  505.  
  506.           <<<<MMMMaaaappppWWWWiiiinnnnddddoooowwww>>>>:
  507.                     Calls the callbacks for XXXXmmmmNNNNmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk if the
  508.                     ColorChooser is a child of a Dialog shell.
  509.  
  510.           <<<<UUUUnnnnmmmmaaaappppWWWWiiiinnnnddddoooowwww>>>>:
  511.                     Calls the callbacks for XXXXmmmmNNNNuuuunnnnmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk if the
  512.                     ColorChooser is the child of a DialogShell.
  513.  
  514.  
  515.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  516.           The bindings for virtual keys are vendor specific.  For
  517.           information about bindings for virtual buttons and keys, see
  518.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))).
  519.  
  520.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  521.           CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX)))), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt((((3333XXXX)))), CCCCoooorrrreeee((((3333XXXX)))),
  522.  
  523.  
  524.  
  525.      Page 8                                         (printed 10/24/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX))))
  533.  
  534.  
  535.  
  536.           XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX)))), SSSSggggCCCCrrrreeeeaaaatttteeeeCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX)))),
  537.           SSSSggggCCCCrrrreeeeaaaatttteeeeCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrDDDDiiiiaaaalllloooogggg((((3333XXXX)))), XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX)))),
  538.           SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrSSSSeeeettttCCCCoooolllloooorrrr((((3333XXXX)))), SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrGGGGeeeettttCCCCoooolllloooorrrr((((3333XXXX)))),
  539.           SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrSSSSeeeettttCCCCuuuurrrrrrrreeeennnnttttCCCCoooolllloooorrrr((((3333XXXX)))),
  540.           SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrSSSSeeeettttSSSSttttoooorrrreeeeddddCCCCoooolllloooorrrr((((3333XXXX)))), and RRRRGGGGBBBBCCCCoooolllloooorrrr((((3333GGGG)))).
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.      Page 9                                         (printed 10/24/98)
  592.  
  593.  
  594.  
  595.